home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / batchut / necho10.zip / NEBEE8H.DOC < prev    next >
Text File  |  1988-07-25  |  6KB  |  131 lines
  1.  
  2.        -----------------------------------------------------------------
  3.                             NECHO  version  1.0
  4.                            ~~~~~~~~~~~~~~~~~~~~
  5.            Copyright (C) 1988 F.M. de Monasterio. All rights reserved
  6.              For personal, non-commercial use only. Cannot be sold.
  7.        -----------------------------------------------------------------
  8.  
  9.  
  10.  
  11.  
  12.     Purpose      NECHO was written as a substitute for DOS's command ECHO
  13.     ~~~~~~~      to allow modification of the video attributes of the text
  14.                  to be displayed on the screen without an ANSI driver.
  15.  
  16.  
  17.     Input        Text to be displayed with interspersed control switches.
  18.     ~~~~~        These switches are characters with an Ascii value from 1
  19.                  (Ctrl-A) to 26 (Ctrl-Z).  They can be entered through the
  20.                  keypad (if allowed by your text editor).  When using DOS'
  21.                  EDLIN or the COPY CON command, the control characters can
  22.                  be entered by pressing the CTRL key and the character key
  23.                  A through Z simultaneously.  Example:
  24.  
  25.                  Necho ^EMake this text ^Fblinking^F and ^Nreversed^N^T
  26.  
  27.                  The following switches are recognized:
  28.  
  29.                  -  ^B = change the foreground text to BLUE
  30.  
  31.                  -  ^G = change the foreground text to GREEN
  32.  
  33.                  -  ^R = change the foreground text to RED
  34.  
  35.                  -  ^Y = change the foreground text to YELLOW
  36.  
  37.                  -  ^W = change the foreground text to WHITE
  38.  
  39.                  -  ^O = change the foreground text to the ORIGINAL color
  40.                     attributes at the time NECHO was invoked.
  41.  
  42.                  -  ^E = erase the screen.  Automatically adjusts for 25 or
  43.                     (EGA) 43 line displays without resetting attributes
  44.                     For obvious reasons, it should only be used at the
  45.                     begining of the text.
  46.  
  47.                  -  ^F = switch from steady to blinking text and vice versa.
  48.                     This is an on-off switch and must be invoked at the
  49.                     beginning of the blinking text and at its end.
  50.  
  51.                  -  ^L = generate a new line (carriage return)
  52.  
  53.  
  54.                  -  ^N = reverse foreground and background. Depending on the
  55.                     foreground color, the reversed text may also blink;
  56.                     this blinking may be avoided by issuing a ^F switch
  57.                     along with ^N.
  58.  
  59.                  -  ^T = trill the bell
  60.  
  61.  
  62.     Output       The filtered text is displayed on the screen.  The output
  63.     ~~~~~~       can be redirected.
  64.  
  65.                  The help screen shown below is displayed when invoking
  66.                  with a null argument:
  67.  
  68.                       ┌──────────────────────────────────────────┐
  69.                       │   Syntax:  NECHO Message with Switches  │
  70.                       ╞══════════════════════════════════════════╡
  71.                       │ CTRL-key (or ASCII equivalent) SWITCHES: │
  72.                       │(Copy CON or Edlin accept these Ctrl-keys)│
  73.                       │                 ──────                   │
  74.                       │ ^B ^Y ┐  change color to Blue, Yellow,  │
  75.                       │  ^G ^R │  Green, Red, White or Original  │
  76.                       │  ^W ^O ┘  foreground message attribute.  │
  77.                       │    ^E ─  clear screen (25 & 43 lines).  │
  78.                       │    ^F ─  set & reset blink attribute.   │
  79.                       │    ^L ─  generate a carriage return.    │
  80.                       │    ^N ─  reverse foreground/background. │
  81.                       │    ^Q ─  quit carriage return on exit.  │
  82.                       │    ^T ─  trill the bell.                │
  83.                       ╞══════════════════════════════════════════╡
  84.                       │  ver 1.10 ── (C) 1988 FM de Monasterio   │
  85.                       └──────────────────────────────────────────┘
  86.  
  87.  
  88.  
  89.    Remarks       Tested in an IBM-AT with an Inboard 386/AT running at a
  90.    ~~~~~~~       Norton SI index of 16.2, and a Landmark test AT "speed"
  91.                  of 24 Mhz operating under DOS 3.1 or 3.2, and an IBM XT
  92.                  running at 4.77 Mhz.
  93.  
  94.    Release       This program and its documentation are copyrighted, and
  95.    ~~~~~~~       distributed free of charge for PERSONAL, NON-COMMERCIAL
  96.                  USE ONLY. For corporate or commercial use, or both, you
  97.                  must register with and obtain a written permission from
  98.                  the author at the address below:
  99.                                                     F.M. de Monasterio
  100.                                                     7013 Barkwater Ct.
  101.                                                     Bethesda, Md 20892
  102.  
  103.    Disclaimer    The author makes no warranty, either implied or expressed,
  104.    ~~~~~~~~~~    including, without limitation, any warranties with respect
  105.                  to the software documented here, its quality, performance,
  106.                  or fitness for any particular purpose.   In no event shall
  107.                  the author be liable for damage, whether direct, indirect,
  108.                  special, incidental, or consequential, that arise from the
  109.                  use of or any defect in the software.   The entire risk as
  110.                  to the quality and performance of the software is with the
  111.                  user.  By using this program, you acknowledge: (1) to have
  112.                  read and understood all parts of the disclaimer and (2) to
  113.                  have agreed with and accepted all of its provisions.
  114.  
  115.  
  116.    Packing       This package contains the following files with the noted
  117.    ~~~~~~~       CRC hexadecimal values:
  118.  
  119.                  NE????h  DOC     6273   7-25-88    1:00   CRC: see name
  120.                  NECHO    COM     4304   7-25-88    1:00   CRC: 0CF7h
  121.  
  122.                  The DOC file contains  6273 characters in  715 words and
  123.                  130 lines; its CRC is shown by the 4 digits in the ARCed
  124.                  DOC file.
  125.  
  126.  
  127.    History       Released on 7-25-87 as NECHO.ARC ver 1.0
  128.    ~~~~~~~
  129.  
  130. F.M. de Monasterio  7-25-88
  131.